AddMultiSerialNoRecordsXML

SoftwareShield CheckPoint™ License Server > CheckPoint™ License Server Interfaces > CheckPoint_Webservice_References > AddMultiSerialNoRecordsXML

## AddMultiSerialNoRecordsXML

The AddMultiSerialNoRecordsXML function will add a Serial Number record by passing an XML format parameter.

###### Syntax

TMultiRecordResponse * AddMultiSerialNoRecordsXML( BSTR SNRecordsXML, BSTR ASessionID ) ;

###### Parameters

SNRecordsXML

[IN] This property is a string value that represents the XML format of a serial record. The format is generally looks like this:

<SN_RECORDS>

<SN_REC SerialNo="1234-3333-3333-4444"

CheckPointUserID="1"

LicenseID="2"

AuthDefIDNo="4"

AuthParameter="0"

TotalActivationsPermitted="123"

OverflowActivationsPermitted="99"

ActivationsConsumed="9">

...

</SN_RECORDS>

#### SN_REC Attributes:

- SNSerialsID : This attribute defines the serial number of the record

- CheckPointUserID : This attribute defines the CheckPoint User ID of the user who generated the serial number

- LicenseID : This attribute defines the license id of the record

- SerialNumber: This attribute defines the serial number of the license

- AuthDefIDNo: This attribute defines the authorization definition number of the record

- AuthParameter: This attribute defines the parameter for Authorization Definitions that requires it.

- TotalActivationsPermitted: This attribute defines the records total number of activations permitted

- OverflowActivationsPermitted: This attribute defines the records total number of overflows permitted.

- ActivationsConsumed: This attribute defines the number of activations and overflow consumed.

ASessionID

[IN] This is the session ID of the logged in user.

###### Remarks

You can also have more then on SN_REC Element between the SN_RECORDS tag to have multiple Serial Number Generated.

The CheckPointUserID is used to keep track of who generated the Serial Number. This should not be mistaken for the End User who will be using the serial number

Also note that this function does not generate a serial number. It only adds the serial number into the database. Use GenerateSN or GenerateSNs if you wish to generate a serial number.

Only CheckPoint administrators are allowed to use this function.

###### Return Value

Returns the custom class TMultiRecordResponse. The fields of interest that is related to this method are:

- Success- this will return false if an exception occurred, otherwise true is returned

- NumRecordsAdded- the number records that was successful added.

- ErrorMessage- if an exception occurred, the associated error message will be found in this field.

###### Function Information

Exposed By Interface: | "ICheckPointService"
Exposed In ISAPI DLL: | "checkpoint.dll"